home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / system / cpcug.zip / LOCATE.DOC < prev    next >
Text File  |  1987-04-20  |  3KB  |  58 lines
  1.           LOCATE                                  Steven Holzner
  2.           Command
  3.           Copyright (c) 1986, Ziff-Davis Publishing Co.
  4.           ______________________________________________________
  5.  
  6.           Purpose:  Searches all files in the current and the
  7.                     root directories of a drive for all
  8.                     occurrences of any specified sequence (e.g.,
  9.                     a word or phrase) of up to 20 ASCII
  10.                     characters. Additional search paths and/or
  11.                     drives may be specified by using Option 1.
  12.  
  13.           Format:   LOCATE searchstring
  14.  
  15.           Remarks:  In addition to returning the path(s) and
  16.                     filename(s) of the file(s) in which the
  17.                     requested string is found, LOCATE puts
  18.                     searchstring into a context of up to 20
  19.                     immediately surrounding characters.
  20.  
  21.                     LOCATE.COM is case sensitive;  the string to
  22.                     be found must be typed exactly.  The program
  23.                     does, however, strip "high-order" (non-ASCII)
  24.                     bits from searchstring, so it can be used,
  25.                     for example with WordStar document files.
  26.  
  27.                     Note:
  28.  
  29.                     1.   Requires the use of DOS 2.0 or later.
  30.  
  31.           Option 1: Normally, if LOCATE does not find the
  32.                     requested string either in the current
  33.                     directory or in the disk's root directory, it
  34.                     simply exits.  It does not automatically
  35.                     search every subdirectory on every drive.
  36.  
  37.                     You can extend the search range, however, by
  38.                     preparing a simple ASCII file that specifies
  39.                     additional paths and/or drives.  The name of
  40.                     this file must be PATH.DAT, and it must be
  41.                     located in the root directory (usually C:\
  42.                     for hard disks, A:\ for floppies).  An
  43.                     example of such a PATH.DAT file would be
  44.  
  45.                     \WORK
  46.                     \LEVEL1
  47.                     \A:
  48.  
  49.                     Each line in the PATH.DAT file must end with
  50.                     a carriage return and specifies an additional
  51.                     path (or drive) for LOCATE to check before it
  52.                     exits.  The PATH.DAT file can be up to 300
  53.                     bytes in length, and incorrectly specified
  54.                     entries are ignored.
  55.  
  56.                     The use of Option 1 will, of course, slow
  57.                     down the overall speed of the search.
  58.